[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
VS_Write()           Write a string to a text file

Description:

  VS_Write() allows the programmer to replace several calls to FWRITE()
  and all the parameters it requires.

Syntax:     

  First Call:

  l_Success = VS_Write( n_Handle )


  Subsequent Calls:

  l_Success = VS_Write( c_String )

Pass:       

  First Call:

  n_Handle is a numeric value representing the DOS file handle
  returned by FCREATE() or FOPEN().

  Subsequent Calls:

  c_String is a character expression containing the information to
  write to the file associated with n_Handle.

Return:     

  l_Success is a logical value that will be set to .T. if VS_Write()
  was successful, otherwise .F.

Notes:      

  YOU MUST CALL VS_WRITE() WITH A DOS HANDLE EACH TIME YOU OPEN A NEW
  FILE!!!

Example:    

  n_Handle = FCREATE( "Myfile.Txt" )
  VS_Write(n_Handle)
  VS_Write("Hello World!")
  FCLOSE(n_Handle)

Usage:      

  When the programmer uses FWRITE() he has to continually use the DOS
  file handle,  VS_Write() remembers the handle and frees the programmer
  from having to re-type the handle so many times in the program file.

See Also: VS_WriteLn()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson